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Abstract 

In this study we have assembled hardware and software to be used for measuring of mechanical vibrations 
in the FREIA-laboratory at Uppsala University. We have utilized an Arduino microcontroller as a slave 
I/O and equipped it with dual accelerometers to be used for vibration measurements and a serial adapter 
which was used to connect the hardware to an EPICS IOC for analysis. Data from the two accelerometers 
have then been cross correlated in order to find a transfer function. Our results where in good agreement 
with theory. 

1 Introduction 


It is of utmost importance when designing 
physical experiments that one takes into ac¬ 
count the mechanical vibrations that may oc¬ 
cur and affect the results. There are several 
ways to measure mechanical vibrations and in 
this study we look closer on how to measure 
them using an MEMS-based accelerometer [3]. 
By using two accelerometers we can see how 
vibrations transfers from one point to another 
and thereby gain some information into the 
characteristics of the medium the vibrations 
propagated through. To provide the accelerom¬ 
eters with power and collect the waveforms, 
an Arduino microcontroller is being used. The 
Arduino functions as a slave IO and can be con¬ 
nected to either MATLAB or an EPICS control 
system. During hardware testing a speaker was 
used to generate desired sine waves, seen in fig¬ 
ure 6. Since this speaker propagates the sound 
directly into the material it is being placed on, 
it proved excellent as a frequency test device 
for the accelerometers. As an real world exper¬ 
iment, we measured the transfer function for a 
vacuum pump at the FREIA-laboratory. 


2 Hardware 



Figure 1: The Arduino Uno rev. 3 


2.1 Arduino 

Arduino is an open source microcontroller that 
has become very popular amongst students, 
hobbyists as well as with professionals. It has 
a very active community and the low cost of 
purchase makes it an excellent tool to quickly 
test and deploy ideas. We have chosen to work 
with the reference model Arduino Uno rev. 3 
that can be seen in figure 1. It measures 68.6 
x 53.4 mm and weights 25 g. It is based on 
the ATmega328 8-bit microcontroller. It has a 
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clock frequency of 16 MHz and a 32 KB flash 
memory. It operates at 5 V and can be pow¬ 
ered over USB or an external power supply. On 
the board there are 6 analog pins and a total 
of 14 digital 1/O Pins and 6 of these provide 
PWM output. There are also pins for power 
management [7]. 

The analog pins which are the ones we mostly 
work with in this project has a resolution of 
10 bits meaning they can handle 1024 different 
values. This is usually done by having each 
value correspond to a voltage between ground 
and 5 V, however this can be changed by using 
the AREF pin (analog reference pin). 

For communication with the Arduino UART 
TTL (5V) serial communication is used. The 
digital pins 0 (RX) and 1 (TX) can also be used 
to send and receive serial data. In the IDE there 
is a built-in serial monitor that can be used to 
send and receive information. When connected 
over USB to a computer the Arduino shows 
up as a virtual COM-port and any software 
capable of serial communication can be used. 


2.2 Accelerometer 


To measure frequencies we use an accelerome¬ 
ter similar to the ones you find in smartphones. 
The accelerometer measures as the name hints 
the acceleration that it being is subjected to. 
The model we have used is mounted on a 
breakout board from SparkFun and use the 
ADXL335 3-axis accelerometer from Analog 
Devices [1]. It measures ±3g in three orthogo¬ 
nal axis labeled the X, Y and Z direction. It can 
read in the range of 0.5 Hz to 1600 Hz for the 
X and Y axis while the Z axis has a range of 0.5 
Hz to 550 Hz. However the SparkFun model 
comes mounted with 0.1 }iF capacitors that acts 
as a low-pass filter and limits the lower band¬ 
width of each axis to 50Hz. 

2 



Figure 2: The accelerometer breakout board with the 
ADXL335 

To operate the accelerometer it needs between 
1.8 V to 3.6 V so we can't use the 5 V output 
on the Arduino and have to use the 3 V. This 
also means that simply plugging one of the 
axis into one of the Arduinos analog input 
pins will lead to complications since it expects 
a maximum value to be 5 V. To solve this we 
connect the supply voltage to the AREF pin 
on the Arduino as well as to the accelerometer 
and in the software tell the Arduino to use this 
voltage as a reference instead of the default 5 V. 

The ADXL335 is a so called MEMS (Micro- 
Electro Mechanical System) accelerometer. The 
sensor in the ADXL335 is a polysilicon surface- 
micromachined sensor that is built on a silicon 
wafer. In the sensor there is a proof mass 
called a seismic mass that is tethered to de¬ 
flectable plates. When subjected to acceleration 
the plates are deflected by the mass and this 
deflection is measured by a differential ca¬ 
pacitor. The differential capacitor is made 
of independently fixed plates and the plates 
that are connected to the seismic mass. The 
fixed plates are driven by 180° out of phase 
square waves and when the plates are deflected 
the differential capacitor gets unbalanced and 
gives an output signal of a square wave whose 
amplitude is proportional to the acceleration. 
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By using demodulation techniques that are 
sensitive to the phase-magnitude and direction 
of the acceleration can be determined. The 
signal is then amplified and taken through a 32 
kQ resistor and now one signal for each axis is 
available. Each signal is then taken through a 
0.1 ]i F capacitor that as was mentioned earlier 
acts as a low-pass filter. The ADXL335 uses 
one structure for the X, Y and Z axis which 
gives the axis high orthogonality that in turn 
leads to little cross-axis sensitivity [9] [2]. 


2.3 Serial adapter 


3 Software 

3.1 Arduino 

The Arduino microcontroller is programed us¬ 
ing the Arduino language, which is based on 
C/C++, and comes with a user-friendly in¬ 
tegrated development environment (IDE) [8]. 
The user only needs to define two functions, 
to make an executable program: a setup() and 
loop() function. The setup() function is only ex¬ 
ecuted once, and is used to initialize variables, 
pin modes etc. The loop() function is essen¬ 
tially a infinite loop that is called repeatedly 
until the device is turned off, this is where your 
code is implemented. These types of programs 
are called cyclic executive programs. 


To be able to integrate the Arduino into the 
EPICS environment used at FREIA it needs to 
be connected to a serial device server using a 
D-sub 9 connector. The serial device server in 
turn gives the device an IP adress and makes 
it accessible over the network. The Arduinos 
digital pin 0 and 1 are by default used as 
RX (receive) and TX (transmit) but this does 
not mean that one can simply attach D-sub 9 
connector and get a working connection. The 
reason for this is that the Arduino communi¬ 
cates with the UART (Universal asynchronous 
receiver/transmitter) protocol that sends data 
with TTL (Transistor-transistor logic) voltage 
levels that are in the interval of 0 V to 5 V 
while the serial device server uses RS-232 that 
uses -15 V to -3 V for 0 and 3 V to 15 V for 
1. communication. The data sent from UART 
can however be converted to work with RS232 
devices by feeding the signal through an inte¬ 
grated circuit named MAX232. The MAX232 
is a dual driver/receiver and works by chang¬ 
ing the outgoing voltage to be in the RS232 
compatible interval of approximatively ± 7.5 
V and the incoming voltage is reduced to be 
between 0 V to 5 V [4], 

For a complete view of all hardware used 
and how to connect it please see figure 11 in 
Appendix 7.1. 



Figure 3: The Arduino IDE. 

While one can create a wide variety of 
programs using only these two functions, the 
loop() function is not ideal for precision high 
speed applications. This is because it runs 
continuously, without the use of a timer [8]. In¬ 
stead, we will be using interrupts, to allow for 
predictable timing, which is essential to high 
speed data collection. The interrupts are imple¬ 
mented using the library MsTimer2 [15]. The 
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library MsTimer2 combines both ease of use 
and good time resolution (1 ms). The events 
that triggers the interrupts are internal timer 
overflows. Each time a timer overflow, a chosen 
function is called and executed, in our case this 
will be a function that reads an analog pin (or 
two simultaneously). The maximum frequency 
of the interrupts is 1 kHz and is determined 
by the time resolution of MsTimer2, and hence 
limits the speed at which we can sample data. 

Listing 1: Reading analog waveform 
// Reads 512 values of analog pin 0 every 
// 1 ms using MsTimer2 
#include <MsTimer2.h> 

const int buffer = 512; // Buffer size 

int analogDataArray[buffer]; 

int count = 0; 

int analogPin = 0; 

int period =1; // Period 

void getWaveformO { 

analogDataArray[count] = 
analogRead(analogPin); 
count++; 

if (count >= buffer) 

MsTimer2::stop(); 
count = 0; 

> 

1 

void setup() { 

analogReference(EXTERNAL); 

MsTimer2::set(period, getWaveform); 
MsTimer2::start(); 

1 

void loopO { 

1 


To read the voltage from an analog pin onboard 
the Arduino, we use the function analogRead(). 
The analog to digital converter (ADC) will 
turn the voltage into an digital signal, ranging 
from 0-1023, where the reference voltage (value 
1023) is set by the function analogReference(). 
Because the ADXL335 accelerometer operates 
using 3.3 V, the function analogReference() will 

4 


be set to EXTERNAL, which indicates that an 
reference voltage will be applied to the AREF 
pin. The time used to read an analog input 
using analogRead() is about 100 /is, therefore 
it does not limit the frequency of which we can 
sample [8]. 

In order to establish serial communication 
between the Arduino slave and EPICS, we 
need call the begin() method of the class Serial. 
The argument of begin() is the baud rate of the 
communication, which will be set to 115200 
Bd. Data will be sent and received as human- 
readable ASCII text, with the methods print() 
and read(). Listing 2 illustrates the simple code 
needed to establish serial communication. 

Listing 2: Exemple showing serial communication 
void setup() { 

Serial.begin(115200); 

1 

void loopO { 

Serial.println("Hello World"); 

y 


To program a useful Arduino slave IO that 
will be able to respond and perform tasks upon 
different commands sent by the EPICS con¬ 
trol system, we will use a switch statement. 
First we have to read the command sent by 
EPICS. This can by done by scanning the in¬ 
coming characters until the terminator charac¬ 
ter is reached, which we have set to newline, 
shown in Listing 3. 

Listing 3: Switch statement, reading serial input 
String input; 

void setup() { 

Serial.begin(115200); 

1 

void loopO { 

while (Serial.available!) > 0) 

{ 

char lastRecived = Serial .readO ; 
input += lastRecived; 
if (lastRecived == ’\n’) 

{ 
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switch (input[0]) { 
case ’W’: 

MsTimer2::set(period, 
getWaveform); 

MsTimer2::start(); 
break; 
default: 

Serial.printlnC'Error") ; 

} 

input = ""; // Clear recieved buffer. 

> 

} 

1 


We use a buffer of 512 elements (limited by the 
memory of the Arduino) to temporarily store 
the waveforms on the Arduino, before the data 
is sent to EPICS or MATLAB [7]. This method 
was not limited by the time delay introduced 
by constantly sending a command and receiv¬ 
ing one data point at a time, which was our 
first approach. 

Appart from acquiring analog values, we also 
implemented digital I/O. The represetive com¬ 
mands are detailed in the appendix 7.2. 

3.2 MATLAB 

MATLAB is a numerical computing environ¬ 
ment that is built around an easy scripting lan¬ 
guage, which makes MATLAB perfect for quick 
testing and data analysis. First, we initialized 
the serial communication between MATLAB 
and the Arduino slave, with the native func¬ 
tion serial(). Using this function, we created 
a serial object and set the parameters DataBits 
= 8, StopBits = 1, BaudRate = 115200. 

serialObj = serial(comPort); 
set(serialObj, ’DataBits’, 8); 
set(serialObj, ’StopBits’, 1); 
set(serialObj, ’BaudRate’, 115200); 


Then we implemented our protocol, see Ap¬ 
pendix 7.2, into different functions that han¬ 


dled the serial communication. Below is the 
function readWaveformO that reads a wave¬ 
form from an analog channel on the Arduino. 

function waveform = ... 

readWaveform(serialObj, analogPin) 

output = [’W’, num2str(analogPin), ]; 

fprintf(serialObj, output); 

input = strsplit(fscanf(serialObj.... 

’%c’), ’ ’); 

if strcmp(output(l:end-l),... 
cell2mat(input(1))) 
waveform = str2double(input(2:end)); 
else 

error(’Error’); 

end 



Frequency [Hz] 

Figure 4: Waveform of a 60 Hz signal. 

With only this simple code we are now able 
to perform tests and evaluate the performance 
of the ADXL335 accelerometer. Figure 4 shows 
the raw waveform obtained by the accelerome¬ 
ter placed near the Adin tone generator playing 
a 60 Hz sine wave. The sine wave was gener¬ 
ated using onlinetonegenerator.com [14]. The 
collected waveform is then transformed from 
the time domain into the frequency domain, 
using fast fourier transform (FFT) [10], which 
is shown in figure 5. The 60 Hz signal is clearly 
distinguished from the background noise. 
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Frequency [Hz] 

Figure 5: Frequency domain of the waveform in 
figure 4. Note the logarithmic scale. 



Frequency [Hz] 


Figure 7: The frequency response of a 100 Hz to 
250 Hz chirp waveform. The colormap represents 
the relative amplitude. 


To test for the frequency response of the 
ADXL355, we generated a linear chirp from 
100 Hz to 250 Hz with the Adin tone generator 
and collected the data over a period of 15 min 
[11]. The response is illustrated in figure 7. All 
lines with a positive slope is harmonics or the 
fundamental. The other lines with negative 
slope are Nyquist reflections. 



Figure 6: The Adin KKBT speaker which has been 
used as a tone generator during the experiments. 


3.3 EPICS 

EPICS (Experimental Physics and Industrial 
Control System) is an open source software 
environment for development and manage¬ 
ment of control systems used globally in small 
and large scale projects [6]. EPICS is available 
for Windows and Linux and in this project 
we used Scientific Linux 6 as operating sys¬ 
tem. The EPICS version used is the standalone 
version CODAC Core System v4.1.0 that is 
distributed by the ITER Organization. EPICS 
utilizes Client/Server and Publish/Subscribe 
techniques to handle communications. In 
an EPICS environment a server is called In¬ 
put/Output Controller and is abbreviated IOC. 
To an IOC multiple sensors and modules can 
be attached for measuring and controlling the 
system. Through the Channel Access (CA) 
network protocol other computers can interact 
with the IOCs and read data and send com¬ 
mands to them. EPICS is very scalable and a 
system can consist of a single IOC for small 
projects to thousands of IOCs for more massive 
projects [6]. 

On an IOC a protocol file is stored that tells 
how the communication with an attached de¬ 
vice should be handle. This is done by defining 
commands in the file that tells EPICS what data 
to send and what to expect in return. There 
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is also a database file, where the records are 
defined. A record tells what commands will 
be available through the CA network. There 
are many different ways records and protocols 
can look like and we will show an example 
of how these can be structured to work with 
each other. The example shows how we mea¬ 
sure a single analog reading from an Arduino 
that has been loaded with our serial protocol. 
When requesting a single analog read from pin 
0 the user should send AO? to the Arduino. 
If the value on the pin at the moment is 496 
the output will be AO 496. We will not cover 
how to install EPICS and create an application 
since there is plenty of guides already available 
online on that topic [5]. 

There are two files that needs to be config¬ 
ured before we can start making our record. In 
the file userPreDriverConf . cmd we configure 
how to connect to the Arduino which we have 
named to be ARDO: 


drvAsynIPPortConfigure("ARDO", 
"192.168.10.9:4003") 


We connect using an IP-adress but other meth¬ 
ods are also possible. All the settings for the 
baud rate, stop bits and so on are handled 
by the serial switch so this is not something 
that needs to be set in this case but for other 
methods this can be configured here. In the 
file dbToLoad. cmd we specify what database to 
load when the IOC starts and what name that 
should be assigned to the variables PREFIX and 
ARD_P0RT: 


dbLoadRecordsC'strdev.db", 

"PREFIX=STRDEV,ARD_PORT=ARDO") 


In the database file strdev. db we have a record 
that looks like this: 


record(ai, "$(PREFIX):A0") { 
field(DTYP, "stream") 
field(INP, "@accel.proto get_analog(0) 
$(ARD_P0RT)") 
field(SCAN, ".5 second") 

> 


In the first row we state that we want to create 
a record by writing record, in the parenthe¬ 
ses that follows afterward we set what type 
of record we will be using. In our exam¬ 
ple it says ai meaning it's an analog input 
record. After that we see "$ (PREFIX): AO" 
and this is the name of the record that will 
be used on the CA network. This is the 
most conventional way of naming records - 
"NameOfDevice: Sensor". Next we see three 
rows of fields, a field is where the settings 
for the record is made. The first row says DTYP 
(which means device type field) and this sets 
what kind of device the record is going to be 
used with. In our example "stream" means 
that we will be using StreamDevice which is 
a device support module for EPICS that facil¬ 
itates the use of devices that communicates 
using strings [16] [12]. The middle row says 
INP which stands for input link, as was said 
earlier this is an analog input record so this is 
where we specify where the input will come 
from. The line "(Saccel.proto get_analog(0) 
$(ARD_P0RT) ") specifies what protocol files to 
use, which in this case is Saccel.proto and 
get_analog what commands to run in the pro¬ 
tocol. The (0) is a variable that can be send 
along to the protocol. This means we can use 
the same the command in the protocol file for 
different inputs. The last field says (SCAN , ". 5 
second") and tells how and when a record pro¬ 
cesses which in this case is set to fetch a new 
value every 0.5 second. The command being 
called by the record in the protocol file is looks 
like this: 


get_analog { 
out "A\$l?"; 
in "A\$l ’/,d"; 

y 


The first row says get_analog and is the name 
of the command that the records use to call it. 
Next we see out "A\$l?" and specifies what 
command will be sent to the Arduino. The \$1 
will be replaced with the variable that was sent 
along from the record which means that the 
command that is sent in this case will be A0?. 
The last row in "A$l °/ 0 d" tells EPICS what to 
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expect back from the Arduino. The A$1 will of 
course once again translate into AO and the °/ 0 d 
means that there will come a signed decimal 
afterwards representing the value of the analog 
pin. 

Once the protocol and database are prepared 
there are several ways to interact with and read 
data from the IOC. The most common way is 
to create a GUI that displays the information 
but the easiest way to see that the application 
works is to use caget in the terminal. The fol¬ 
lowing code shows how to start the application 
called accel and read data from the record 
that we created in the example above: 


[UserSlocalhost ~]$ 

./target/main/scripts/accel-ioc start 
Starting IOC accel [ OK ] 

[UserSlocalhost ~]$ caget STRDEV:AO 
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4 Results 

We have shown that our system, hardware 
and software, is working as predicted when 
subjected to tests with known outcomes. The 
next step was to test it on an unknown source, 
which we chose to be a running vacuum pump 
from Scrollvac. The pump was connected to 
the cryostat in the FREIA-laboratory and was 
bolted to the concrete floor. To measure the 
transmitted frequencies from the pump to the 
floor, we placed one accelerometer directly to 
the pump and the other on the nearby floor, 
illustrated in figure 8. Using MATLAB and 
the correlation command, see appendix 7.2, on 
the Arduino, we recorded data from both ac¬ 
celerometers simultaneously when the pump 
was running. The frequency domain of the 
waveforms are presented in figure 9. The trans¬ 
fer function is created by dividing the trans¬ 
formed response waveform by the transformed 
source waveform. Figure 10 shows the transfer 
function. All frequencies below a value of one 
are affected while the frequencies above one 
are amplified. 



Figure 8: One accelerometer mounted with red tape 
on a vacuum pump and one with red tape on a metal 
cube on the floor 



[HZ] 


Figure 9: Data of vibrating vacuum pump from two 
accelerometers shown in the frequency domain. One 
is located at the base of the pump and the other is 
placed directly on the pump. Note the logarithmic 
scale. 



Figure 10: The transfer function of the data obtained 
in figure 9. 

5 Conclusion 

We can conclude from our results that it is pos¬ 
sibly to perform reliable data acquisition and 
analysis using low-cost and easily available 
hardware and software. 
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7 Appendix 

7.1 Circuit diagram 



Figure 11: Circuit diagram showing all necessary connections for this project. Note that only the x-axis on 
the accelerometers are connected. This diagram was created using the software Fritzing [13]. 
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7.2 Command List 


Here is a full list of all the supported commands used in our serial protocol. 


Command 

Response 

Description 

AX? 

AX N 

Get one single value from an analog channel. 

WX? 

WX N N N. . . 

Returns the waveform from an analog channel. 

CXY? 

CXY N N N. . . 

Returns two waveforms from different analog chan¬ 
nels (measured at the same time). 

P? 

P N 

Returns the sampling period. 

PN 

PN 

Sets the sampling period. 

M? 

M NNNNNNNNNNNNNN 

Returns the IO mask 

MNNNNNNNNNNNNNN 

MNNNNNNNNNNNNNN 

Sets the IO mask 

MXN 

MXN 

Set the value of a specific digital pin. 

DX? 

DX N 

Returns the value of a digital channel. 

DXN 

DXN 

Sets the value of a digital channel. 

Q? 

Q NNNNNNNNNNNNNN 

Returns all the digital channel values. 

V? 

V S 

Returns the software version. 

? 

s 

Returns some information about the device. 


The terms X, Y denotes different pins onboard the Arduino (analog and digital), N is an integer 
corresponding to the data given by the command and S' is a string. Note that every command 
that asks for a value N ends with a question mark. 


7.3 MATLAB code 


function serialObj = setupSerial(comPort, baudRate) 

Initializes serial port communication between Arduino and MATLAB 

serialObj = serial(comPort); 

set(serialObj, ’DataBits’,8); 

set(serialObj, ’StopBits’,1); 

set(serialObj, ’BaudRate’.baudRate); 

set(serialObj, ’Parity’none’); 

set(serialObj, ’InputBufferSize’, 4096); 

end 


function waveform = readWaveform(serialObj, analogPin) 
H Read single waveform from analog pin on the Arduiono 

if mod(analogPin, 1) > le-6 

error(’Analog pin must be an integer.’); 

end 

if analogPin <011 analogPin > 5 

error(’Analog pin must have a value from 0-5.’); 
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output = num2str(analogPin), ]; 

fprintf(serialObj, output); 

input = strsplit(f scant (serialObj, ’’/ t c’), ’ ’); 

if strcmp(output(1:end-1), cell2mat(input(1))) 
waveform = str2double(input(2:end)); 

error(’Error’); 


function [waveforml, waveform2] = readTwoWaveforms(serialObj, analogPinl, analogPin2) 
Read waveforms from two analog pins on the Arduiono simultaneously 

if mod(analogPinl, 1) > le-6 I I mod(analogPin2, 1) > le-6 
error(’Analog pins must be an integer.’); 

if analogPinl <011 analogPinl >511 analogPin2 <011 analogPin2 > 5 
error(’Analog pins must have a value from 0-5.’); 

output = [’C’, num2str(analogPinl), num2str(analogPin2), ’?’]; 
fprintf(serialObj, output); 

input = strsplit(fscanf (serialObj, ’’/ t c’), ’ ’); 

if strcmp(output(1:end-1), cell2mat(input(1))) 
waveforml = str2double(input(2:end/2+0.5)); 
waveform2 = str2double(input(end/2+1.5:end)); 
else 

error(’Error’); 



function [] = setlOMask(serialObj, mask) 

"/,’/, Sets the 10 mask on the Arduino 

if length(mask) ~= 14 

error(’I0 mask must be of length 14’); 

if any(mask > 1) I I any(mask < 0) II any(mod(mask, 1) > 0) 
error(’I0 mask must only contain ones or zeros’); 

output = regexprep(mat2str(mask), ’[~\w]’, ’’); 
fprintf(serialObj, [’M’, output]); 
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fscanf (serialObj , ’"/.s’) 


function [] = setDigitalPin(serialObj, digitalPin, mode) 
°/°/, Sets the mode of a digital pin 

if digitalPin <011 digitalPin > 13 

error(’Analog pin must have a value from 0-5’); 


if mode <011 mode > 1 I I mod(mode, 1) > 0 
error(’Mode must be ether 0 or 1’); 


if digitalPin < 10 

num = [’O’, num2str(digitalPin)]; 
else 

num = num2str(digitalPin); 

end 

fprintf(serialObj, [’D’, num, num2str(mode)]); 
fscanf (serialObj , ’"/.s’); 


7.4 Arduino code 


// 

// Arduino 
// 

// Author 
// 

// Date 
// Version 
// 

// See 
// 


Slave 

Adam Hjort, Mans Holmberg 

2015-03-11 00:00 

1.0 

ReadMe.txt for references 


// Include libraries 
#include <MsTimer2.h> 


// Define variables and constants 

const int NUM_ANAL0G =6; // Total number of analog pins available 
const int NUM_DIGITAL = 14; // Total number of digital pins available 
const int BUFFER = 512; // Buffer size 
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int analogDataArray[BUFFER]; // Array to store waveform 

int analogPinl; 

int analogPin2; 

int count = 0; 

float in, out; 

long period =1; // Period of interupt (maximum period is 2.15 billion seconds) 
boolean digitalPinMask[14] ={1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1>; //An array that 
holds the current 10 modes for all digital pins 
String input; //A string containing the input from the serial communication 
String ver = "1.0"; // Software version 

// getOneWaveform 

// 

// Brief Reads "BUFFER" number of value of one analog pin at accurate time periods. 

// 

void getOneWaveform() { 

analogDataArray[count] = analogRead(analogPinl); 
count++; 

if (count >= BUFFER) 

{ 

MsTimer2::stop(); 
count = 0; 

} 


void SinSerialO { 

if ((input.charAt(2) == ’?’) && (input.charAt(3) == ’\n’)) 
{ 

for (in =0; in < 6.283; in = in + 0.001) 

{ 

out = sin(in) * 127.5 + 127.5; 

Serial.println(out); 

} 

Serial.print(’\n’); 

} 

{ 

Serial.println("Error"); 

} 


// getTwoWaveform 

// 

// Brief Reads "BUFFER"/2 number of value of two analog pins simultaneously at accurate 
time periods. 

// 

void getTwoWaveform() { 

analogDataArray[count] = analogRead(analogPinl); 
count++; 

analogDataArray[count] = analogRead(analogPin2); 
count++; 

if (count >= BUFFER) 
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MsTimer2::stop(); 
count = 0; 


// analogSerial 

// 

// Brief Returns a single value from chosen analog channel. 

// 

void analogSerial() { 

if ((input.charAt(1) > ’/’) && (input.charAt(1) < NUM_ANAL0G + ’O’) 
&& (input.charAt(2) == ’?’) && (input.charAt(3) == \n’)) 

{ 

input.remove(2, 2) ; 

Serial.print(input); 

Serial.print(" "); 

Serial.print(analogRead(input.charAt(1) - ’0’)); 

Serial.print("\n"); 

} 


{ 


Serial.println("Error"); 


// waveformSerial 

// 

// Brief Retunrs a waveform from chosen analog channel. 

// 

void waveformSerial() { 

if ((input.charAt(1) > ’/’) && (input.charAt(1) < NUM_ANAL0G + ’O’) 
&& (input.charAt(2) == ’?’) && (input.charAt(3) == ’\n’)) 

{ 

analogPinl = input.charAt(1) - ’O’; 

MsTimer2::set(period, getOneWaveform); 

MsTimer2::start(); 
delay(BUFFER * period); 
input.remove(2, 2); 

Serial.print(input); 

for (int i = 0; i < BUFFER; i++) 

{ 

Serial.print(" "); 

Serial.print(analogDataArray[i] ); 
analogDataArray[i] = 0; 

> 

Serial.print(’\n’); 

} 


{ 

Serial.printlnC'Error") ; 

} 
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// correlationSerial 

// 

// Brief Retunrs two waveforms from chosen analog channels, that was capturet 
simultaneously. 

// 

void correlationSerial() { 

if ((input.charAt(1) > ’/’) && (input.charAt(1) < NUM_ANAL0G + >0’) 
kk (input.charAt(2) > ’/’) && (input.charAt(2) < NUM_ANALOG + O’) 

kk (input.charAt(1) != input.charAt(2)) 
kk (input.charAt(3) == ’?’) kk (input.charAt(4) == ’\n’)) 

{ 

analogPinl = input.charAt(1) - ’O’; 
analogPin2 = input.charAt(2) - ’O’; 

MsTimer2::set(period, getTwoWaveform); 

MsTimer2::start(); 
delay(BUFFER * period); 
input.remove(3, 2) ; 

Serial.print(input); 

for (int i = 0; i < BUFFER; i += 2) 

{ 

Serial.print(" "); 

Serial.print(analogDataArray[i]); 
analogDataArray[i] = 0; 

> 

for (int i = 1; i < BUFFER; i += 2) 

{ 

Serial.print(" "); 

Serial.print(analogDataArray[i]); 
analogDataArray[i] = 0; 

> 

Serial.print(’\n’); 

> 

{ 

Serial.println("Error"); 

} 

1 

// periodSerial 

// 

// Brief Can be used to either get or set the sampling period. 

// 

void periodSerial() { 

// Returns the sampling period 
int inputLength = input.length(); 

if ((input.charAt(1) == ’?’) kk (input.charAt(2) == \n’)) 

{ 

input.remove(1, 2); 

Serial.print(input); 

Serial.print(" "); 
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Serial.println(period); 

} 

// Sets the sampling period 

else if (inputLength > 2 && (input.charAt(inputLength - 1) == ’\n’)) 

{ 

input.remove(0, 1); 

boolean isCorrect = true; 

for (int i = 0; i < inputLength - 2; i++) 

{ 

if (input.charAt(i) < ’/’ II input.charAt(i) > 

i 

isCorrect = false; 

} 

> 

if (isCorrect) 

{ 

long tempPeriod = input.tolnt(); 
if (tempPeriod > 0) 

{ 

Serial.print("P") ; 

Serial.println(tempPeriod); 
period = tempPeriod; 

} 

| 

Serial.printlnC'Error"); 

> 

> 

Serial.printlnC'Error"); 

> 

I 

{ 

Serial.println("Error"); 

} 

1 

// maskSerial 

// 

// Brief Can be used to either get or set the 10 mask of the digital pins 
output). 

// 

void maskSerial() { 

// Returns the 10 mask for the digital pins 
int inputLength = input.length(); 

if ((input.charAt(1) == ’?’) && (input.charAt(2) == ’\n’)) 

{ 

input.remove(1, 2); 

Serial.print(input); 


(1 = input 0 = 
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Serial.print(" "); 

for (int i = 1; i < NUM_DIGITAL + 1; i++) 

{ 

if (digitalPinMask[i] == 0) 

{ 

Serial.print("0") ; 

> 

{ 

Serial.print("1" ) ; 

} 

> 

Serial.print(’\n’); 

} 

// Sets the 10 mask for the digital pins 
else if (input.charAt(NUM_DIGITAL + 1) == >\n’) 

{ 

boolean isCorrect = true; 

for (int i = 1; i < NUM_DIGITAL + 1; i++) 

{ 

if ((input.charAt(i) != ’O’) && (input.charAt(i) != ’1’)) 

{ 

isCorrect = false; 

} 

> 

if (isCorrect == true) 

{ 

input.remove(NUM_DIGITAL + 1, 1); 

for (int i = 0; i < NUM_DIGITAL + 1; i++) 

i 

digitalPinMask[i] = input.charAt(i) - ’O’; 
pinMode(i, !digitalPinMask[i]); 

} 

Serial.println(input); 

> 

{ 

Serial.println("Error"); 

> 

} 

// Set the 10 status of a specific digital pin 

else if ((inputLength > 3) && (inputLength < 6) && (input.charAt(inputLength - 1) == 
’ \n ’) ) 

{ 

input.remove(0, 1); 

input.remove(inputLength - 1, 1); 

boolean isCorrect = true; 

for (int i = 0; i < inputLength - 2; i++) 

{ 

if (input. char At (i) < , /'■ II input. char At (i) > ’:’) 

{ 
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isCorrect = false; 

} 

> 

int value = input.charAt(inputLength - 3) - ’O’; 
input.remove(inputLength - 3, 1); 
if (isCorrect) 

{ 

int digitalPin = input .toIntO ; 

if ((digitalPin >= 0) && (digitalPin < NUM_DIGITAL) && (value == 0 I I value == 1)) 

1 

Serial.printC'M") ; 

Serial.print(digitalPin); 

Serial.println(value); 
digitalPinMask[digitalPin + 1] = value; 
pinMode(digitalPin, lvalue); 

} 

I 

Serial.println("Error"); 

} 

> 

{ 

Serial.println("Error"); 

> 

} 

{ 

Serial.println("Error"); 

} 

1 

// digitalSerial 

// 

// Brief Can be used to either get or set the value of a digital pin (1 = low 0 = high). 

// 

void digitalSerial() { 

// Sets the value of a specific digital pin 
int inputLength = input. lengthO ; 

if ((inputLength > 3) && (inputLength < 6) kk (input.charAt(inputLength - 1) == ’\n’) 
kk (input.charAt(inputLength - 2) != ’?’)) 

{ 

input.remove(0, 1); 

input.remove(inputLength - 1, 1); 

boolean isCorrect = true; 

for (int i = 0; i < inputLength - 2; i++) 

if (input.charAt(i) < ’/’ II input.charAt(i) > ’:’) 

{ 

isCorrect = false; 
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> 

> 

int value = input.charAt(inputLength - 3) - ’O’; 
input.remove(inputLength - 3, 1); 
if (isCorrect) 

{ 

int digitalPin = input.tolnt(); 

if ((digitalPin >= 0) kk (digitalPin < NUM_DIGITAL) kk (value == 0 I I value == 1)) 

1 

Serial.print("D"); 

Serial .print(digitalPin); 

Serial.println(value); 
digitalWrite(digitalPin, value); 

} 

i 

Serial.println("Error"); 

} 

> 

{ 

Serial.println("Error"); 

> 

} 

// Returns the value of a specific digital pin 
else if ((inputLength > 3) kk (inputLength < 6) kk 

(input.charAt(inputLength - 2) == ’?’) kk (input.charAt(inputLength - 1) == 

’\n’)) 

{ 

input.remove(0, 1); 

input.remove(inputLength - 3, 2); 

boolean isCorrect = true; 

for (int i = 0; i < inputLength - 3; i++) 

if (input.charAt(i) < ’/’ II input.charAt(i) > ’:’) 

{ 

isCorrect = false; 

> 

> 

if (isCorrect) 

int digitalPin = input.tolnt(); 

if ((digitalPin >= 0) kk (digitalPin < NUM_DIGITAL)) 

{ 

Serial.printC'D") ; 

Serial.print(digitalPin); 

Serial.print(" "); 

Serial,println(digitalRead(digitalPin)); 

> 
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Serial .printlnC'Error") ; 

> 

> 

{ 

Serial.printlnC'Error") ; 

> 

} 

{ 

Serial.printlnC'Error") ; 

} 

1 

// getAUDigital 

// 

// Brief Returns the values of all digital pins (1 = input 0 

// 

void getAUDigital () { 

if ((input.charAt(1) == ?’) && (input.charAt(2) == ’\n’)) 

{ 

input.remove(1, 2); 

Serial.print(input); 

Serial.print(" "); 

for (int i = 0; i < NUM_DIGITAL; i++) 

{ 

Serial.print(digitalRead(i)); 

> 

Serial.print(’\n’); 

| 

{ 

Serial.printlnC'Error") ; 

} 


// versionSerial 

// 

// Brief Returns current software version 

// 

void versionSerial() { 

if ((input.charAt(1) == 71 ) && (input.charAt(2) == ’\n’)) 

{ 

input.remove(1, 1); 

Serial.print("V "); 

Serial.println(ver); 

} 


{ 

Serial.printlnC'Error") ; 

} 

1 


= output). 
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// Setup 

// 

// Brief Setup 

// 

void setup0 { 

// Setup 

bitClear(ADCSRA, ADPSO); // Running with high speed clock (set prescale to 16) 
bitClear(ADCSRA, ADPS1); 
bitSet(ADCSRA, ADPS2); 

Serial.begin(115200); // Sets Serial baud rate 

analogReference(EXTERNAL); // Configures the reference voltage used for analog input 

y 

// 

// Brief Loop 

// 

void loopO { 

while (Serial.available() > 0) 

// Adds input char to the string "input" while there still is characters to read 

{ 

char lastRecived = Serial.readO ; 

input += lastRecived; // Adds last recived char to "input" 
if (lastRecived == ’\n’) 

// Continue to do stuff if the last character recived was a new line 

{ 

switch (input [0]) { 

analogSerialO ; 

case ’W’: 
waveformSerialO ; 

correlationSerialO ; 

case ’P’: 
periodSerialO ; 

case ’M’: 
maskSerialO ; 

case ’D’: 
digitalSerialO ; 

case ’Q’: 
getAUDigitalO ; 
break; 
case ’S’: 

SinSerialO ; 
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versionSerialO ; 

// Returns some information about this device 
Serial.printlnC'Arduino slave") ; 

Serial.print("Version "); 

Serial.println(ver); 

Serial.printlnC"Uppsala University, Sweden"); 

Serial.printlnC'Software written by Adam Hjort and Mans Holmberg"); 
break; 
default: 

Serial.printlnC'Error") ; 

} 

input = // Clear recieved buffer. 

> 

} 

1 
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